home *** CD-ROM | disk | FTP | other *** search
/ Atari Forever 4 / Atari Forever 4.zip / Atari Forever 4.iso / SERIE_S / S_902 / PRUEFSUM / HANDBUCH.TXT next >
Text File  |  1998-03-14  |  12KB  |  269 lines
  1. Anleitung zu >PRUEFSUM.PRG<:
  2. ============================
  3.  
  4. Wer hatte das nicht schon mal, eine Datei war "verstümmelt" oder ein 
  5. Programm lief nicht korrekt oder gar nicht mehr. Oftmals kann 
  6. es an einer falschen Systemkonfiguration liegen, in einigen Fällen 
  7. können aber auch die entsprechenden Dateien "defekt" sein.
  8. Ist ein Duplikat vorhanden, kann man dann dieses verwenden.
  9. Was aber, wenn nicht? Einen Fehler kann man in der entsprechenden 
  10. Datei zwar vermuten, aber Gewißheit hat man nicht immer.
  11.  
  12. >PRUEFSUM.PRG< kann zukünftig je nach Einsatz für Abhilfe sorgen!
  13. Um es vorweg zu sagen, eine defekte Datei kann es jedoch auch nicht 
  14. "reparieren".
  15.  
  16.  
  17.  
  18. Wozu dient >PRUEFSUM.PRG< generell?
  19. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  20. Es berechnet von einzelnen Dateien (egal welcher Typ) eine 
  21. Prüfsumme, die auf dem CRC-Algorithmus basiert. Dieser ist so 
  22. aufgebaut, daß von allen Bytes einer Datei eine logische Prüfsumme 
  23. errechnet wird. Dabei werden nicht nur die einzelnen Bytes 
  24. aufaddiert, sondern auch miteinander verknüpft. So werden z. B. von 
  25. der selben Datei, wenn von dieser 2 Bytes vertauscht worden sind, 
  26. diese "Verdreher" sicher erkannt. Näher soll auf das Verfahren nicht 
  27. eingegangen werden.
  28.  
  29. Mit >PRUEFSUM.PRG< hat man also ein Werkzeug zur Hand, mit dessen 
  30. Hilfe man von Dateien deren Prüfsumme berechnen lassen kann, um 
  31. diese zu einem späteren Zeitpunkt zu einem Dateivergleich 
  32. heranzuziehen. Spätestens dann, wenn mit diesen Dateien was nicht in 
  33. Ordnung ist (Kopierfehler, Transport, usw.).
  34.  
  35.  
  36.  
  37. Wo kann >PRUEFSUM.PRG< eingesetzt werden?
  38. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  39. 1.) Überall dort wo Dateien (Programme) in Umlauf gebracht werden 
  40. (z. B. auf dem PD-Sektor). Der Autor eines Programms läßt mit 
  41. >PRUEFSUM.PRG< von seinen einzelnen Dateien eines Ordners deren 
  42. Prüfsummen berechnen, die in der speziellen Datei >PRUEFSUM.CRC< 
  43. gesichert werden. Der spätere Anwender, oder man selbst, kann dann 
  44. bei Bedarf einen Prüfsummenvergleich vornehmen.
  45.  
  46. 2.) Ein Anwender hat Probleme mit einem Programm und weiß nicht ob 
  47. es an diesem selbst liegt. Zufällig hat ein entfernt wohnender 
  48. Freund von diesem das selbe Programm. Ist jener auch im Besitz von 
  49. >PRUEFSUM.PRG<, können beide schnell ein Prüfsummenvergleich beider 
  50. identischen Programme vornehmen und diese telefonisch mitteilen. So 
  51. muß für eine Neubeschaffung nicht erst der Postweg eingeschaltet 
  52. werden, zumal man ja nicht weiß, ob wirklich ein Fehler in der Datei 
  53. vorliegt.
  54.  
  55. 3.) Zweckentfremdet läßt sich >PRUEFSUM.PRG< auch zum Vergleichen 
  56. von Dateien haranziehen. So z. B. hat man von einer XYZ-Datei mit 
  57. gleicher Länge(!) mehrere Versionen, von denen man aber nicht weiß, 
  58. inwieweit sie sich voneinander unterscheiden. Bei gleicher Prüfsumme 
  59. zweier Dateien, besteht somit auch Gleichheit.
  60.  
  61.  
  62.  
  63.  
  64. Die Handhabung von >PRUEFSUM.PRG<.
  65. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  66. Nach Start des Programms befinden Sie sich in einer GEM-Umgebung mit 
  67. den Menüleisteneinträgen 'Info', 'Quit', 'CRC' und 'Menü-Hilfe'.
  68.  
  69. 'Menü-Hilfe' enthält den Menüpunkt '   ein- / ausschalten'. Wählen 
  70. Sie diesen an, wird ihnen zu den einzelnen anderen Menüpunkten eine 
  71. kurze Hilfestellung gegeben. Hierzu nur aus der erscheinenden Box 
  72. 'Ein' anklicken. Wählen Sie nun einen der anderen Menüpunkte, wird 
  73. kurz umrissen wofür er da ist und welche Optionen enthalten sind. 
  74. Aus dieser Box heraus können Sie nun entweder die Funktion mit 
  75. 'Start' aufrufen, oder mit 'Abbruch' wieder verlassen, ohne daß 
  76. dabei weiteres geschieht. Durch nochmaligen Aufruf der Menü-Hilfe, 
  77. kann die Hilfestellung wieder abgeschaltet werden.
  78.  
  79.  
  80.     'CRC' beinhaltet 4 Wahlmöglichkeiten:
  81.  
  82.      BERECHNE Prüfsumme(n) von:
  83. a)     einzelnen Dateien - manuell
  84. b)     mehreren Dateien  - autom.
  85.      ------------------------------
  86. c)   Vergleiche Prüfsummen
  87.  
  88.  
  89. a) Von einzelnen Dateien Prüfsumme berechnen:
  90.  
  91. Sie können sich die CRC-Prüfsumme einer einzelnen Datei berechnen 
  92. lassen und zeigen lassen. Hierzu aus der Fileselektbox eine Datei 
  93. nach Wahl anklicken.
  94.  
  95.  
  96. b) Von mehreren Dateien automatisch Prüfsummen berechnen:
  97.  
  98. Es werden ab einer von Ihnen vorgegebenen Direktorie-Ebene, von 
  99. allen Dateien deren CRC-Prüfsummen berechnet. Mit der Fileselektbox 
  100. nur den Pfad bestimmen und dann mit Feld "OK" oder RETURN-Taste 
  101. verlassen. Hierbei gilt die hierarchische Ordnung, das heißt, ab 
  102. dieser Ebene werden alle Dateien erfaßt und alle Ordner durchsucht, 
  103. incl. derer, die sich in diesen wiederum befinden. Zuvor wird auf 
  104. der vorgegebenen Ebene automatisch die Datei >PRUEFSUM.CRC< 
  105. angelegt. In dieser werden von allen gefundenen Dateien deren 
  106. Pfadname (nur ab der vorgegebenen Ebene), der Dateiname und deren 
  107. CRC-Prüfsumme gesichert. Je nach Anzahl und Länge der Dateien, 
  108. dauert der Vorgang mehr oder weniger lang. Ist das Ende erreicht, 
  109. werden Sie darauf hingewiesen.
  110.  
  111.  
  112.  
  113.  
  114. c) Von mehreren Dateien die CRC-Prüfsumme (später) vergleichen:
  115.  
  116. Hier wird der umgekehrte Weg beschritten. Von den Dateieinträgen in 
  117. >PRUEFSUM.CRC< werden die Dateien in den jeweiligen Ordnern gesucht, 
  118. deren Prüfsumme erneut berechnet und mit den Werten aus 
  119. >PRUEFSUM.CRC< verglichen. Hierzu müssen Sie den Pfad aus der 
  120. Fileselektbox vorgeben, wo die entsprechende Datei >PRUEFSUM.CRC< zu 
  121. finden ist. Haben Sie den Pfad eingestellt, dann nur mit Feld "OK" 
  122. oder RETURN-Taste wieder verlassen, >PRUEFSUM.CRC< selber braucht 
  123. nicht gewählt zu werden. Danach erfolgt der Prüfsummen-Vergleich. Je 
  124. nach Anzahl und Länge der Dateien, dauert der Vorgang mehr oder 
  125. weniger lang. Ist er durchgeführt, erhalten Sie die Meldung, ob und 
  126. wie viele Fehler aufgetreten sind. Sie haben nun die Möglichkeit die 
  127. entsprechenden Dateien auf dem Bildschirm zeigen zu lassen, oder 
  128. diese in eine separate Datei >FEHLER.CRC< zu sichern. Diese wird 
  129. immer auf der Direktorie-Ebene angelegt, wo auch die Datei 
  130. >PRUEFSUM.CRC< sich zu diesem Prüfsummen-Vergleich befindet. Die 
  131. Fehlerdatei kann nach Gebrauch verworfen werden. Nicht vergessen, 
  132. nach Bildschirm-Auflistung eine Taste zur Fortführung drücken!
  133.  
  134. WICHTIG!
  135. In >PRUEFSUM.CRC< sind die Dateinamen mit deren Pfad ab(!)
  136. Erfassungsebene abgelegt, deshalb darf die Direktorie-Struktur der 
  137. eigentlichen (zu Prüfenden) Dateien nicht verändert werden, auch 
  138. nicht zu einem späteren Zeitpunkt. Insgesamt dürfen diese Dateien 
  139. (vorzugsweise in Ordnern) incl. >PRUEFSUM.CRC< an jede andere Stelle 
  140. Kopiert werden.
  141.  
  142. Zum Beispiel wurde vom Ordner Test_1 von dessen enthaltenen Dateien 
  143. (1-4) die Prüfsumme berechnet. In Ordner TEST_1 wird vom Programm 
  144. die Datei >PRUEFSUM.CRC< angelegt:
  145.  
  146.   H:\
  147.      DIVERSE_1\
  148.      DIVERSE_2\
  149.                TEST_1\
  150.                       DATEI_1.PRG          ¯¯¯|
  151.                       DATEI_2.CSC             |
  152.                       DATEI_3.INF             |
  153.                       PRUEFSUM.CRC            |
  154.                       TEST_2\                 |
  155.                              DATEI_4.DOC   ___|
  156.      DIVERSE_3\
  157.  
  158.  
  159.          ^           |            ^
  160.          ^           |            ^
  161.  unberücksichtigter  |     berücksichtigter
  162.      Pfad-Name       |         Pfad-Name
  163.  
  164. In >PRUEFSUM.CRC< enthalten die Dateien (1-3) keine Pfadangabe, der 
  165. Datei (4) wurde jedoch der Ordner TEST_2 vorangestellt. Der 
  166. komplette Ordnerinhalt von TEST, kann an eine beliebige 
  167. andere Stelle kopiert werden. Die Datei in Ordner TEST_2 muß auch 
  168. weiterhin in selbigem Ordner verbleiben, ebenso >PRUEFSUM.CRC<, dort 
  169. wo es angelegt wurde! 
  170.  
  171.  
  172.  
  173.  
  174. Was sonst noch zu erwähnen währe.
  175. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  176. Da der eigentliche Zweck eine spätere Überprüfung auf Korrektheit 
  177. der Dateien ist, muß bei Weitergabe der (geprüften) Dateien, auch 
  178. immer die Datei >PRUEFSUM.CRC< auf gleicher Ebene mitgegeben werden. 
  179. Natürlich sollte auch das Programm >PRUEFSUM.PRG< mit Anleitung 
  180. Bestandteil sein.
  181.  
  182.  
  183.  
  184. Im Ordner >PRUEFSUM< ist ein weiterer Ordner namens >PRFSTEST< 
  185. enthalten. Dieser enthält das Programm >PRFSTEST.PRG<, welches nur, 
  186. einmal gesicherte Prüfsummen, vergleichen kann. Diese Funktion 
  187. entspricht der Option  "VERGLEICHE Prüfsummen" dieses Programmes.
  188. Es ist in erster Linie für den Endanwender gedacht, der sich u. U. 
  189. nicht näher mit dem Hauptprogramm >PRUEFSUM.PRG< befassen, sondern 
  190. eben nur seine Dateien überprüfen möchte. Dabei kann dann von ihm 
  191. auch nichts falsch gemacht werden.
  192. Sind Sie Programmierer oder Verbreiter von Dateien aller Art, und 
  193. möchten diese Art der Dateienüberprüfung dem Anwender zukommen 
  194. lassen, so kopieren Sie dieses Programm in Ihr Softwarepaket.
  195. Hierfür wird >PRFSTEST.PRG< auf die Direktorie-Ebene kopiert, wo 
  196. sich die Datei >PRUEFSUM.CRC< angelegt wurde. Der Endanwender 
  197. braucht hier nur das Testprogramm aufrufen, welches dann ohne 
  198. weiteres Zutun den Vergleichstest durchführt. Die kleine zugehörige 
  199. Anleitung, oder eine selbstabgefaßte, sollte sich auch auf dieser 
  200. Ebene befinden.
  201.  
  202.  
  203.  
  204. In Verbindung mit Bildschirm-Schonern wurde ein nachteiliger Effekt 
  205. festgestellt. Ist/wird der Schoner während des Berechnungsphase 
  206. aktiv (schont das Bild), sinkt die Rechenleistung drastisch, 
  207. wodurch Sie unnötig länger warten müssen. Dieses Verhalten ist von 
  208. Schoner zu Schoner jedoch verschieden. Da dem so ist, "verbraten" 
  209. diese wohl einen Teil der Prozessorleistung. Bei einem meiner 
  210. Schoner ("Markenprodukt") wurde die Ausführungszeit um den Faktor 5 
  211. verringert. Bei einem anderen älteren Datums, erfolgten in dieser 
  212. Zeit sogar keine Festplattenzugriffe!
  213.  
  214. **  Lassen Sie also von größeren Datenbeständen die Prüfsummen  **
  215. **  neu berechnen oder vergleichen, ist es sehr empfehlenswert  **
  216. **    den Bildschirm-Schoner für diese Zeit zu deaktivieren.    **
  217.  
  218.  
  219.  
  220. --------------------------------------------------------------------
  221.  
  222.  
  223.  
  224. >PRUEFSUM.PRG< wurde auf einem TT mit TTM-194 Monitor entwickelt. Es 
  225. läuft auch auf kleineren Monitoren, in hoher / (und mit sehr hoher 
  226. Wahrscheinlichkeit) in mittlerer Auflösung, sowie auf jedem Atari-
  227. Modell.
  228. Die maximale Anzahl der Datei-Einträge in >PRUEFSUM.CRC< ist auf 
  229. 10000 begrenzt, dessen Grenze aber wohl nie erreicht werden wird.
  230. Das Programm stellt sich auf den Computertyp ein, das heißt, 
  231. findet es einen TT vor, wird das Programm in das TT-Fast-Ram geladen 
  232. und die vorhandene FPU verwendet, wodurch alles flotter geht.
  233. Trotzdem es mit GfA-Basic geschrieben wurde, läuft es 
  234. verhältnismäßig schnell. Um von einer Datei mit 100000 KB Länge die 
  235. Prüfsumme zu errechnen, benötigt es auf einem TT unter Einbindung 
  236. der FPU, und Programmlauf im TT-Fast-Ram, "nur" 4.3 Sekunden.
  237. Im ST-Ram und ohne FPU werden etwa 6.5 Sekunden benötigt. Bei einem 
  238. 8 MHz ST dauert es dann leider nochmal etwas länger.
  239.  
  240. >PRUEFSUM.PRG< entstand aus Eigenbedarf heraus. Wie zuvor unter 2.) 
  241. beschrieben, hatte ein Verwandter zeitweise Probleme mit 
  242. Programmen die ich auch besaß. Da wir aber 800 Km auseinander 
  243. wohnen, mußte ein Weg gefunden werden, um den Fehler schnell und 
  244. sicher zu lokalisieren.
  245. Mit der Zeit wurde es um einige starke Funktionen erweitert, so daß 
  246. nun in dieser vorliegenden Version (1.0) ein automatischer Ablauf 
  247. möglich ist. Momentan fällt mir keine weitere zu realisierende 
  248. Option ein. Aber vielleicht fehlt gerade Ihnen das Eine oder Andere, 
  249. lassen Sie es mich dann wissen.
  250.  
  251.  
  252. --------------------------------------------------------------------
  253. >PRUEFSUM.PRG< wurde mit GfA-Basic 3.6D geschrieben und compiliert. 
  254. Durch dessen Einsatz ist ein Schaden auf Festplatte oder Diskette 
  255. nicht zu erwarten. Dennoch kann für irgendwelche Schäden keine 
  256. Haftung übernommen werden. Das Programm hat den Status PD. 
  257. --------------------------------------------------------------------
  258.  
  259.  
  260.                               /\
  261.                          |)  /¯¯\pholz 
  262.                          |)urkhardt © 1995
  263.  
  264.  
  265.   _______________________________________________________________
  266.   Copyright bei Burkhardt Apholz, Schulstraße 1, 78532 Tuttlingen
  267.                     Telefon & FAX:  07461-78723
  268.   ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  269.